Inside Macintosh: QuickDraw GX Objects /

Chapter 2 - Shape Objects / Shape Objects Reference

Functions / Manipulating Shape Object Properties

GXSetShapeInk

You can use the GXSetShapeInk function to change the ink object associated with a shape object.

void GXSetShapeInk(gxShape target, gxInk newInk);

target

A reference to the shape whose ink object is to be changed.

newInk

A reference to the new ink object to associate with the target shape.

DESCRIPTION

The GXSetShapeInk function disassociates the ink object already associated with the target shape and disposes of it. The function then assigns the ink object referenced by the newInk parameter to the target shape and increments the owner count of the new ink object.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
ink_is_nil
shape_access_not_allowed	(debugging version)
Notices (debugging version)
ink_already_set

SEE ALSO

The relationship of ink objects to QuickDraw GX shapes is discussed in "About QuickDraw GX Shapes" beginning on page 2-5. Ink objects themselves are further discussed in the chapter "Ink Objects" in this book.

To determine the ink object associated with a QuickDraw GX shape, use the GXGetShapeInk function, described in the previous section.